home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / MPW / UnDumpFile 1.01 / README next >
Encoding:
Text File  |  1994-12-01  |  2.6 KB  |  61 lines  |  [TEXT/R*ch]
  1. /***
  2.  *
  3.  *    UnDumpFile.cp - MPW tool to rebuild a binary file from a hex dump
  4.  *    Copyright © Christopher E. Hyde, 1994.  All rights reserved.
  5.  *
  6.  *    Version:    1.01
  7.  *    Usage:        UnDumpFile -o outputFile [inputFiles...]
  8.  *
  9.  ***/
  10.  
  11. /*
  12.   DESCRIPTION:
  13.     This simple MPW tool written in C++ creates a binary data file by reading the hexidecimal 
  14.     byte codes in a file created by the MPW tool 'DumpFile'.  This allows a binary file to be 
  15.     'dumped' edited (by inserting or removing hex bytes) and then 'undumped'.
  16.  
  17.   USAGE:
  18.       The command line is of the form:
  19.         UnDumpFile -o outputFile [inputFiles...]
  20.     The input files are effectively concatenated together and then parsed to form the 
  21.     output file.
  22.  
  23.     Often followed by a command line of the form:
  24.         SetFile -c 'crea' -t 'type' outputFile
  25.  
  26.     Lines in the input file are expected to be of the form:
  27.         <Address> ':' <Hex Byte Codes>      <ASCII Chars>
  28.     or more precisely:
  29.         spc* hex+ ':' <' ' hex hex>«1,16» [spc+ ?*]
  30.     Any optional whitespace, followed by 1 or more hex digits, followed by a colon, followed 
  31.     by between 1 and 16 space-hexdigit-hexdigit sequences, optionally followed by a whitespace 
  32.     and any characters up to a caridge return.  The maximum line length is 256 caracters.
  33.     Lines that are not of this form are ignored.  The <Address> and <ASCII Chars> are also 
  34.     ignored.  Therefore lines could be commented out by placing a '#' at the start.  And 
  35.     lines may be inserted by placing something such as '0: F1 E2 D3 ...' on a line between 
  36.     any other lines.  Individual bytes may be removed by deleting the appropriate hex code 
  37.     (and preceeding space).  Individual bytes may be inserted by splitting a line into two 
  38.     and adding '0: ' at the begining of the second (to maintain the correct form).
  39.  
  40.     NOTE: If a line contains less than 16 hex bytes followed by exactly one space followed by 
  41.     2 hex digits (from the <ASCII Chars> to the right) then this will be interpreted as an 
  42.     additional data byte.  Also each <Hex Byte Code> must be separated by exactly one space 
  43.     from the previous one.  These problems may only occur in an edited line.
  44.  
  45.     NB. Hex bytes are specified by pairs of characters that are either the digits '0' to '9' 
  46.     or the upper-case letters 'A' to 'F'.  The lower-case letters 'a' to 'f' are not accepted.
  47.     The modification of the program to accept these characters is left as an exercise to the 
  48.     user ;-)
  49.  
  50.   CONTACTING THE AUTHOR:
  51.     Bug reports, suggestions, comments, thanks, congratulations and currency bills of any 
  52.     denomination will be gratefully accepted by the author.
  53.  
  54.         Internet:    drjekyll@hylight.demon.co.uk
  55.         Post:        Christopher E. Hyde
  56.                     HyLight Limited
  57.                     25 Carson Road
  58.                     London  E16 4BD
  59.                     England (UK)
  60. */
  61.